風險代幣訊息
介面描述
取得AI透過多資料面向，對當前行情下具有下跌風險趨勢的代幣的追蹤訊息資料。
使用情境：
- 適用於當前行情下，對有下跌行情風險的代幣，進行AI即時追蹤的訊息查詢
- 適用於了解出貨預警、下跌風險、反弹等風險訊號
資料更新頻率：每5分鐘更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/ai/getRiskCoinMessageList
點數消耗
- 消耗點數：
5
前置條件
取得 vsTokenId
| 條件 | 說明 | 取得方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用快取的 vsTokenId，無需重複查詢 | 上下文自動提取 |
| 未有 vsTokenId | 呼叫 POST /vs-token/list 介面取得 | 前置介面呼叫 |
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
| 參數名 | 類型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代幣 ID |
回應欄位
僅展示 data 陣列內每個物件的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 更新時間（毫秒時間戳） |
| vsTokenId | long | string | VS Token ID |
| symbol | string | string | 代幣名稱 |
| name | string | string | 代幣名稱 |
| riskMessageType | integer | integer | 預測類型 |
| scoring | number | number | 得分（可能回傳空字元串） |
| grade | integer | integer | 等級（可能回傳空字元串） |
| price | number | string | 幣價 |
| percentChange24h | number | number | 24 小時跌漲幅 |
| riskDecline | number | number | 風險跌幅 |
| rebound | number | number | 反弹 |
欄位業務含義
| 欄位 | 業務含義 | 使用建議 |
|---|---|---|
| riskMessageType | 風險訊息類型 | 識別風險訊號類型，如出貨預警、下跌風險、反弹等 |
| riskDecline | 風險跌幅 | 推送後價格下跌幅度，用於驗證風險預警準確性 |
| rebound | 反弹幅度 | 價格下跌後的反弹程度 |
請求範例
json
{
"vsTokenId": 38178 // 代币id
}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getRiskCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 38178
}'cURL 範例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getRiskCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 38178}"成功回應範例
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1771317300000, // 更新时间
"vsTokenId": "38178", // VS Token ID
"symbol": "TRUTH", // 代币名称
"name": "Swarm Network", // 代币名称
"riskMessageType": 19, // 预测类型
"scoring": "", // 得分
"grade": "", // 等级
"price": "0.011799", // 币价
"percentChange24h": -2.32385979, // 24 小时跌涨幅
"riskDecline": 26.376997000000003, // 风险跌幅
"rebound": 6.613434999999999 // 反弹
},
{
"updateTime": 1771317000000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.013825",
"percentChange24h": -0.69409195,
"riskDecline": 15.444089,
"rebound": 4.466107
},
{
"updateTime": 1771316700000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.014154",
"percentChange24h": -0.69409195,
"riskDecline": 10.402556,
"rebound": 0.927115
}
// ... 更多数据省略
],
"requestId": "xxx-xxx-xxx"
}